Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Compatibility Messages

GXPrOpenPage

QuickDraw GX sends the GXPrOpenPage message when an application that supports the Macintosh Printing Manager calls the PrOpenPage function. You can override the GXPrOpenPage message to customize the handling of the PrOpenPage function. Your override of the GXPrOpenPage message must match the following formal declaration:

OSErr MyPrOpenPage (TPPrPort aTPPrPort, TPRect aTPRect, 
                     Point resolution);

aTPPrPort

A pointer to a TPPrPort record.

aTPRect

The rectangle used as the QuickDraw picture frame for this page.

resolution

The resolution to be used in printing the page.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of the GXPrOpenPage message generates the GXStartPage message. You can override this message to add any special handling that your printer driver requires at the time that a page is spooled for printing.

SPECIAL CONSIDERATIONS

You never send the GXPrOpenPage message yourself.

You almost always forward the GXPrOpenPage message so that the default implementation can perform its operations.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The PrOpenPage function is described in Inside Macintosh: Imaging With QuickDraw.

The GXStartPage message is described on page 4-55.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help